*
* Creating a #PangoLayout object is the first step in rendering text,
* and requires getting a handle to a #PangoContext. For GTK+ programs,
- * you'll usually want to use gtk_widget_get_pango_context(), or
+ * you’ll usually want to use gtk_widget_get_pango_context(), or
* gtk_widget_create_pango_layout(), rather than using the lowlevel
* gdk_pango_context_get_for_screen(). Once you have a #PangoLayout, you
* can set the text and attributes of it with Pango functions like
*
* Gets the pattern used to clear the background on @window. If @window
* does not have its own background and reuses the parent's, %NULL is
- * returned and you'll have to query it yourself.
+ * returned and you’ll have to query it yourself.
*
* Returns: (transfer none): The pattern to use for the background or
* %NULL to use the parent’s background.
#endif /* HAVE_XKB */
/* Whether we were able to turn on detectable-autorepeat using
- * XkbSetDetectableAutorepeat. If FALSE, we'll fall back
+ * XkbSetDetectableAutorepeat. If FALSE, we’ll fall back
* to checking the next event with XPending().
*/
*
* If you want to use a different base pixbuf for different icon
* variants, you create multiple icon sources, mark which variants
- * they'll be used to create, and add them to the icon set with
+ * they’ll be used to create, and add them to the icon set with
* gtk_icon_set_add_source().
*
* By default, the icon source has all parameters wildcarded. That is,
* Accelerator maps are used to define runtime configurable accelerators.
* Functions for manipulating them are are usually used by higher level
* convenience mechanisms like #GtkUIManager and are thus considered
- * “low-level”. You'll want to use them if you're manually creating menus that
+ * “low-level”. You’ll want to use them if you're manually creating menus that
* should have user-configurable accelerators.
*
* An accelerator is uniquely defined by:
* You can also force an expose event by adding to the “damage region”
* of the drawing area’s window; gtk_widget_queue_draw_area() and
* gdk_window_invalidate_rect() are equally good ways to do this.
- * You'll then get a draw signal for the invalid region.
+ * You’ll then get a draw signal for the invalid region.
*
* The available routines for drawing are documented on the
* [GDK Drawing Primitives][gdk3-Cairo-Interaction] page
* is clicked.
*
* Note that as the user scrolls around in the entry the offsets will
- * change; you'll need to connect to the “notify::scroll-offset”
+ * change; you’ll need to connect to the “notify::scroll-offset”
* signal to track this. Remember when using the #PangoLayout
* functions you need to convert to and from pixels using
* PANGO_PIXELS() or #PANGO_SCALE.
/* The pointers we return for a GtkFileSystemVolume are opaque tokens; they are
* really pointers to GDrive, GVolume or GMount objects. We need an extra
- * token for the fake “File System” volume. So, we'll return a pointer to
+ * token for the fake “File System” volume. So, we’ll return a pointer to
* this particular string.
*/
static const gchar *root_volume_token = N_("File System");
*
* Creates a new icon theme object. Icon theme objects are used
* to lookup up an icon by name in a particular icon theme.
- * Usually, you'll want to use gtk_icon_theme_get_default()
+ * Usually, you’ll want to use gtk_icon_theme_get_default()
* or gtk_icon_theme_get_for_screen() rather than creating
* a new icon theme object for scratch.
*
* The markup passed to gtk_label_set_markup() must be valid; for example,
* literal <, > and & characters must be escaped as \<,
* \gt;, and \&. If you pass text obtained from the user, file,
- * or a network to gtk_label_set_markup(), you'll want to escape it with
+ * or a network to gtk_label_set_markup(), you’ll want to escape it with
* g_markup_escape_text() or g_markup_printf_escaped().
*
* Markup strings are just a convenient way to set the #PangoAttrList on
/* These are used when a destination-side DND operation is taking place.
* Normally, when a file is being hovered directly over a bookmark,
- * we'll be in DROP_STATE_NORMAL.
+ * we’ll be in DROP_STATE_NORMAL.
*
* But when a file is being hovered between bookmarks, this means the user
* may want to create a new bookmark for that file between those bookmarks.
* @Title: GtkScale
*
* A GtkScale is a slider control used to select a numeric value.
- * To use it, you'll probably want to investigate the methods on
+ * To use it, you’ll probably want to investigate the methods on
* its base class, #GtkRange, in addition to the methods for GtkScale itself.
* To set the value of a scale, you would normally use gtk_range_set_value().
* To detect changes to the value, you would normally use the
* ignored. This structure has object semantics - no fields should be
* modified directly, they should not be created directly, and
* pointers to them should not be stored beyond the duration of a
- * callback. (If the last is changed, we'll need to add reference
+ * callback. (If the last is changed, we’ll need to add reference
* counting.) The time field gives the timestamp at which the data was
* sent.
*/
* This function is used to initialize a GTK+ test program.
*
* It will in turn call g_test_init() and gtk_init() to properly
- * initialize the testing framework and graphical toolkit. It'll
+ * initialize the testing framework and graphical toolkit. It’ll
* also set the program’s locale to “C” and prevent loading of rc
* files and Gtk+ modules. This is done to make tets program
* environments as deterministic as possible.
* @percentage: value between 0 and 100.
*
* This function will adjust the slider position of all GtkRange
- * based widgets, such as scrollbars or scales, it'll also adjust
+ * based widgets, such as scrollbars or scales, it’ll also adjust
* spin buttons. The adjustment value of these widgets is set to
* a value between the lower and upper limits, according to the
* @percentage argument.
* name-value pairs, terminated by %NULL
*
* This function wraps g_object_new() for widget types.
- * It'll automatically show all created non window widgets, also
+ * It’ll automatically show all created non window widgets, also
* g_object_ref_sink() them (to keep them alive across a running test)
* and set them up for destruction during the next test teardown phase.
*
* pasted text will be inserted at the cursor position, or the buffer selection
* will be replaced if the selection is non-empty.
*
- * Note: pasting is asynchronous, that is, we'll ask for the paste data and
+ * Note: pasting is asynchronous, that is, we’ll ask for the paste data and
* return, and at some point later after the main loop runs, the paste data will
* be inserted.
**/
}
/* the accel_key and accel_mods fields of the key have to be setup
- * upon calling this function. it'll then return whether that key
+ * upon calling this function. it’ll then return whether that key
* is at all used as accelerator, and if so will OR in the
* accel_flags member of the key.
*/
projects / gtk4.git / commitdiff